home *** CD-ROM | disk | FTP | other *** search
/ PC World Interactive 6 / PC World Interactive 6.iso / online / wtalk11.EXE / WINTALK.DOC < prev    next >
Text File  |  1994-03-04  |  23KB  |  524 lines

  1.                    ---*---
  2.  
  3.     WINTALK - a Microsoft Windows (tm) talk client/server
  4.  
  5.                  Version 1.1
  6.  
  7.            FreeWare from ELF Communications
  8.  
  9.                    ---*---
  10.  
  11.  
  12. Contents:
  13. =========
  14.  
  15. 1.0......Introduction
  16.  
  17. 2.0......Installation
  18.  
  19. 2.1......On Names and Addresses
  20.  
  21. 3.0......Usage
  22.  
  23. 4.0......Configuration
  24.  
  25. 5.0......Known bugs
  26.  
  27. 6.0......Troubleshooting
  28.  
  29. 7.0......About ELF
  30.  
  31.  
  32.               1.0  Introduction
  33.               =================
  34.  
  35.     WinTalk allows Windows users who have the WINSOCK DLL
  36. installed on their system to participate in real-time conversations
  37. with remote users, using the popular Unix "ntalk" (and its older
  38. cousin, "talk") protocol.  The program acts as both a talk client and
  39. server, responding to remote talk requests with a pop-up "ring"
  40. dialog, an auditory ring, or both.
  41.  
  42.     WinTalk is provided as FreeWare, and thus you may freely
  43. distribute it providing 1) the distribution is *not* for profit, and
  44. 2) all files are included and unchanged (including this doc file).  ELF
  45. Communications takes no responsibility for the results of using or
  46. misusing this software.  Please see the end of this file for the full
  47. text of the disclaimer under which this software is provided.
  48.  
  49.     If you have comments or questions, send email to
  50. "wintalk@elf.com".  I'm working hard on other projects, so don't be
  51. surprised if replies take a while.
  52.  
  53. **************************************************************************
  54. **   If you are having troubles with gethostname() or gethostbyname(),  **
  55. **   please read the "On Names and Addresses" section in this file      **
  56. **   *before* sending email.                        **
  57. **************************************************************************
  58.  
  59.  
  60.               2.0  Installation
  61.               =================
  62.  
  63.     To install WinTalk, simply transfer the wintalk.zip file to
  64. your system, and unpack it using pkunzip or a similar zip
  65. decompression tool (as you've probably already done if you've gotten
  66. this far :)).  You will find several files:
  67.  
  68. README.1ST   -  The readme : please read first!
  69. WINTALK.DOC  -  This file
  70. WINTALK.EXE  -  The actual program
  71. CTL3D.DLL    -  Microsoft's "3d" control DLL
  72. BWCC.DLL     -  Borland's Custom Control DLL
  73. DINGDING.WAV -  The initial "ring" sound
  74.  
  75.     IF YOU DO NOT HAVE A SOUND CARD, and you wish to have
  76. auditory alerts of talk requests, you will want to get the PC speaker
  77. driver, available at ftp.cica.indiana.edu, or one of their mirror
  78. sites.  Look for a self-extracting archive called SPEAK.EXE, in the
  79. win3/sounds directory.
  80.  
  81.     Transfer the "dingding.wav" file to your WINDOWS directory,
  82. so WinTalk can find it; if you plan to use another sound for
  83. WinTalk's "ring", or no sound, this is not necessary.
  84.  
  85.     You must have versions of both BWCC.DLL and CTL3D.DLL in your
  86. path.  If you don't already have them, copy the versions distributed
  87. with WinTalk into your WINDOWS directory.
  88.  
  89.     You must also have a WINSOCK.DLL that operates with your
  90. windows TCP/IP networking stack.  For more information on this,
  91. please contact your network vendor.
  92.  
  93.     You may now run WinTalk via the Program Manager's File->Run
  94. menu command, or use File->New to create an icon for WinTalk in an
  95. appropriate Program Manager group.  I'd recommend placing the WinTalk
  96. icon in the "startup" group under Program Manager - this way, you
  97. will always be able to receive talk requests if you so desire.
  98.  
  99.  
  100.              2.1  On Names and Addresses
  101.              ===========================
  102.  
  103.     (Feel free to skip this section IF you already understand the
  104.      DNS, and your PC has a DNS-registered hostname.  If you are
  105.       seeing "gethostname()" or "gethostbyname()" errors, PLEASE
  106.                read this section)
  107.  
  108.     The most common problems using WinTalk (by far) involve
  109. configuring DNS (Domain Name System) names for your PC.  This section
  110. explains a little about the DNS, and what you need to have set up for
  111. WinTalk to be happy.
  112.  
  113.     Any host on a TCP/IP network is identified by 32-bit number
  114. called an IP Address, which is often written as four numbers
  115. separated by periods : for instance, "192.48.232.17".  This number is
  116. very useful when machines need to talk to each other, but not so nice
  117. for humans to deal with.  This is where the DNS comes in.  The DNS is
  118. a network directory service, translating names such as
  119. "frobozz.elf.com" into IP addresses.
  120.  
  121.     Many winsock applications can get by just using your
  122. machine's IP address, but due to the particulars of the TALK protocol
  123. as implemented on most Unix systems, this is not the case with
  124. WinTalk.  Hence, you need to have a couple of things configured
  125. correctly before you can use WinTalk.
  126.  
  127.     First, your machine must know its hostname for WinTalk
  128. to successfully start.  Please refer to the documentation included
  129. with your networking stack (Trumpet, PC/TCP, NetManage, PC-NFS,
  130. etc...) to find out how to do this.  If you do *not* have a hostname
  131. configured, WinTalk will start up with a messagebox that says:
  132.  
  133.     ["Couldn't get my hostname!"]
  134.  
  135.     Now, your hostname can live on your local machine (in your
  136. network stack's configuration), and it can (and should) also live on
  137. a DNS server.  The DNS server will be queried for your name when you
  138. try to talk to someone on a unix machine - so if your PC is not
  139. registered on an appropriate DNS server, you will *not* be able to
  140. talk to anyone running Unix talk!!  If you try, you will see the
  141. "Target machine does not recognize us" message in the status bar of
  142. your talk window.  Also, some implementations of the winsock DLL
  143. (Trumpet, for example) will query the DNS server for your IP address
  144. when WinTalk starts up.  In this situation, if you aren't registered,
  145. WinTalk will fail with a messagebox reading:
  146.  
  147.     ["Couldn't get host info!"]
  148.  
  149.     To register your machine in the DNS, you need to talk to your
  150. system administrator.  The specifics vary from machine to machine.
  151.  
  152.     (In some cases, winsock users will be connecting to the
  153. internet via a SLIP connection which gives them a *variable* IP
  154. address; it can change every time they call their host systems.  In
  155. these cases, you'll be fine *if* every possible address is associated
  156. with a name.  If this is not the case, and for some reason your sysadmin
  157. does not want things set up that way, you're out of luck...)
  158.  
  159.     Please make sure you're correctly registered in the DNS
  160. before writing to wintalk@elf.com about gethostname() or
  161. gethostbyname() problems.
  162.  
  163.  
  164.                   3.0  Usage
  165.                   ==========
  166.  
  167. Getting Started
  168. ---------------
  169.  
  170.     When you start WinTalk, the talking-smiley icon will appear
  171. at the bottom of your screen.  This icon indicates WinTalk is up and
  172. running, listening for talk requests directed to your PC.  The
  173. default configuration is to announce any talk request received by
  174. your PC, for any user, with a sound and a dialog box.  See
  175. "Configuration" below for information on changing this and other
  176. options.
  177.  
  178.     The first time you run WinTalk, it will ask you for a
  179. username.  This name will be used as the default "from" name in your
  180. talk requests.  So if you entered "Milo" and your PC was called
  181. "bloom-county.frobozz.com", a foreign user would see a talk request
  182. from "Milo@bloom-county.frobozz.com" when you talked them.  Local
  183. usernames can also be used to filter incoming talk requests - see
  184. "Configuration" below.
  185.  
  186. Initiating a Talk
  187. -----------------
  188.  
  189.     To start a talk session with someone, click once on the
  190. WinTalk icon, and select "Talk..." from the menu.  A dialog will
  191. appear asking who you'd like to talk to (this defaults to the last
  192. address you talked, and any of the last 50 talk destinations can be
  193. selected by clicking the down-arrow), and who the request should
  194. appear to be from (this defaults to the first username in the
  195. "local users" list, and any of the configured usernames can be
  196. selected by clicking the down-arrow).  You can use any name you like
  197. in the "from" field; it does not have to be one of your configured
  198. usernames.  You may also select which protocol (old or new talk) you
  199. would like to use.  NTALK is the modern Unix standard, and should do
  200. for talking to most systems.  If you are trying to reach someone on a
  201. machine running SunOS, or on a pre-4.2BSD system, try old talk
  202. instead.
  203.  
  204. Answering a Talk
  205. ----------------
  206.  
  207.     When a remote user tries to talk you (with either NTALK or
  208. old talk), and you have the "Dialog" option enabled (see
  209. "Configuration / Announcement Styles" below), a pop-up dialog will
  210. appear indicating who is trying to reach you.  You will be asked
  211. whether to Accept, Refuse, or Ignore the request.  If you Accept, a
  212. new conversation window will appear, and you will be connected to the
  213. calling party.  Selecting "Refuse" will dismiss the dialog, and the
  214. foreign user will be informed that you are refusing messages.  If you
  215. choose "Ignore", the dialog will be dismissed, and the foreign user
  216. will see the "Ringing your party again..." message until they decide
  217. to cancel the talk.
  218.  
  219.     If the "Dialog" option is disabled, or as an alternative to
  220. dealing with the pop-up, you may select the "Answer..." option from
  221. the WinTalk icon menu when you hear the ring sound.  This will bring
  222. up a list of all active talk requests, and allow you to act on any or
  223. all of them.  Simply select the request you'd like to deal with, and
  224. the press the "Accept", "Refuse", or "Ignore" buttons (see previous
  225. paragraph).
  226.  
  227.  
  228. Talking
  229. -------
  230.  
  231.     Once you initiate or accept a talk, a talk window will
  232. appear, and the progress of the session will appear in the status
  233. bar.  If you're initiating, WinTalk will retry for 1.5 minutes before
  234. timing out on a talk request - you may close the talk window at any
  235. time to cancel the request.  Normally, though, you'll see the
  236. "Waiting for your party to respond...." message.  Once your party
  237. talks back at you, the status bar will read "Connected!!", and you
  238. may begin typing to your friend.  If you're answering, you should see
  239. the "Connected!!" status almost immediately.
  240.  
  241.     At this point, you will be able to see what the remote user
  242. types, and whatever you type will be sent to them.  You may use the
  243. standard Windows copy and paste commands to copy text to and from
  244. WinTalk.  When you "Paste" into the talk window, the text will be
  245. sent across the network connection as if you'd typed it.
  246.  
  247.     WinTalk will automatically format your text to fit the window
  248. size of your talk window.  This can cause strange-looking screens on
  249. the remote side, since most Unix systems don't have automatic
  250. formatting.  You can remedy this with the "Auto-wrap" feature of
  251. WinTalk.  Just enter the width of the remote user's screen, and
  252. WinTalk will automatically insert line breaks where appropriate to
  253. keep your text neatly formatted.  The status bar reminds you of the
  254. current auto-wrap setting, and you may set a default remote screen
  255. width in the configuration dialog (see _Configuration_ below).  NOTE:
  256. WinTalk will automatically detect if the other party is also running
  257. WinTalk, and turn off auto-wrap for that session if so.
  258.  
  259.     The menu also allows you to bring up a "window style" dialog
  260. to change the look of an ongoing conversation; the fonts, colors, and
  261. orientation of the text windows.  Click "Apply" to try out the
  262. changes you make in the current talk session *without* changing the
  263. defaults, and "Set Defaults" to save the changes in the wintalk.ini
  264. file - all future talks will then begin with the new settings.  See
  265. "Using the Window Style Dialog" in Configuration, below.
  266.  
  267.     Hitting ^C during a conversation will close the talk
  268. connection without closing the window - this is useful if you still
  269. wish to scroll back over the stored text.  Alternately, closing the
  270. window (by either double-clicking the closebox or selecting
  271. File->Exit) will automatically close the connection.
  272.  
  273.  
  274. Muting
  275. ------
  276.  
  277.     If you are busy with work, or are leaving your PC for a
  278. while, you may wish to temporarily disable WinTalk's announcement
  279. facility.  To do this, simply select "Disable" from the icon menu.
  280. The WinTalk icon will change from the "excited" smiley face to the
  281. "sleeping" smiley, to remind you that talks are currently being
  282. refused.  While in this state, anyone who tries to talk you will get
  283. a message reading either "User is refusing messages" or "User is not
  284. logged in" (see "Configuration" below).  To reenable, simply bring up
  285. the icon menu and select "Enable" (pretty intuitive, huh?).  The icon
  286. should pop back to the "excited" smiley face.
  287.  
  288.  
  289.  
  290.               4.0 Configuration
  291.               =================
  292.  
  293.     Selecting "Configure..." from the WinTalk icon menu will
  294. bring up the configuration dialog.  This allows you to set defaults
  295. for the various options available in WinTalk.  The options are:
  296.  
  297.  Local Usernames:
  298.  ================
  299. Use the self-explanatory "Add" and "Delete" buttons to change your
  300. list of local usernames.  When "Local Users" is selected in the
  301. request filtering section, WinTalk will only accept requests for the
  302. users in this listbox.  Requests for others will be rejected with a
  303. "not logged in" message.
  304.  
  305.  Default Protocol:
  306.  =================
  307. Defines which protocol (NTALK or Old-talk) will be the default for
  308. new talk destinations.  WinTalk will remember the protocol setting
  309. you use for each destination in your pick-list, however.
  310.  
  311.  Ring Sound:
  312.  ===========
  313. The .wav file which will be played if you have the "Sound" announce
  314. style switched on.
  315.  
  316.  Request Filtering:
  317.  ==================
  318. You may choose to have WinTalk announce no talk requests (foreign
  319. users will be told you are refusing messages), all talk requests
  320. regardless of username, or only talk requests for the usernames in
  321. the local username listbox.  Even if WinTalk is configured to
  322. announce no incoming requests, you will still be able to make
  323. outgoing talks (and the WinTalk icon will change to a sleeping smiley
  324. to remind you that all requests will be refused).
  325.  
  326.  Announcement Style:
  327.  =================== 
  328. When a talk request is announced, you can choose how you'd like to
  329. hear about it.  WinTalk can play a "ring" sound, pop up a dialog, or
  330. both.  You may select both options, but at least one must always be
  331. active.
  332.  
  333.  Default Window Style:
  334.  ===================== 
  335. Pressing the "Edit" button will bring up the same Window Style dialog
  336. you use during a talk session, except the "apply" button will be
  337. disabled.  If you like the look of the "mini" talk window in the
  338. dialog after playing with the settings, press the "Set Defaults"
  339. button, and your changes will be saved.
  340.  
  341. Using the Window Style Dialog:
  342. ------------------------------
  343.  
  344. The Window Style dialog shows you a miniature mock-up of the talk
  345. window.  You can click the "switch orientation" button to try out the
  346. other window layout, the "choose font" button to select a new font,
  347. or the "edit colors" button to change the text & background colors.
  348.  
  349. When you click the "edit colors" button, a color palette will appear,
  350. and the "local" window in the mock-up will be highlighted with a thin
  351. dotted line.  You can switch the highlight to the "remote" window and
  352. back by left-clicking on the mock-up windows.  The color of the
  353. currently selected window can be changed by clicking any of the
  354. palette colors - if you LEFT-click, the text color will change.  If
  355. you RIGHT-click, the background color will change.  Clicking the
  356. "edit colors" button again will make the palette disappear.
  357.  
  358. When you are satisfied with the look of the mock-up window, click
  359. "Apply" to apply the settings to your current talk session *without*
  360. setting the defaults, or "Set Defaults" to save the current settings
  361. for all future talk sessions.  Clicking "cancel" will close the
  362. dialog without saving your changes.
  363.  
  364.  Default auto-wrap:
  365.  ==================
  366. This allows you to set a default screen width for foreign users.  If
  367. you frequently talk to people using 80-column displays, it's a good
  368. idea to set this to 75, so you don't have to worry about your text
  369. running off the edge of their screen.  WinTalk shuts off auto-wrap
  370. automatically when it connects to another WinTalk (v1.1 or later).
  371.  
  372.  Message on disable:
  373.  ===================
  374. When you select "Disable" from the smiley-face icon menu, users who
  375. try to talk you will see one of two messages - you can choose which
  376. one by pressing the appropriate radio button.  The first is "User is
  377. refusing messages", the second is "User is not logged in".  This can
  378. help to indicate whether you are away from your desk or busy.
  379.  
  380.  
  381.                5.0  Known Bugs
  382.                ===============
  383.  
  384. Known Bugs
  385. ----------
  386.  
  387. * Some fonts do not default correctly, and will revert to "System"
  388.    across WinTalk invocations.
  389.  
  390. * WinTalk does not work well with Sun Select's PC-NFS winsock
  391.    implementation...you'll see an "Error #10050" box every time you
  392.    try to initiate a talk.  The problem is being researched.
  393.  
  394. * WinTalk seems to have problems with the Novell and Microsoft
  395.    winsock stacks - we've just gotten a copy of Novell, and I haven't
  396.    yet tested either.  Version 1.1 may solve the problems (if they
  397.    were due to stack size, for instance), and it may not.  We should
  398.    be getting Microsoft's TCP/IP in a week or two, and I'll see what
  399.    I can do about these problems.
  400.  
  401.  
  402.              6.0  Troubleshooting
  403.              ====================
  404.  
  405. (this section is pretty minimal for now, but will be expanded)
  406.  
  407. 1.  "I get a 'Control Socket Bind' error when I start WinTalk!"
  408.  
  409.     This usually is associated with error #10048, ADDRINUSE.
  410. This means that some other program has already grabbed a UDP socket
  411. on the TALK or NTALK port.  To solve this, consult your network
  412. stack's documentation or support people, and turn off their talk
  413. daemon.
  414.  
  415. 2.  "WinTalk won't start, it complains about my hostname/host info!"
  416.  
  417.     Please read Section 2.1 - On Names and Addresses.
  418.  
  419. If you're still having trouble, send email to wintalk@elf.com, and
  420.   don't forget to include:
  421.     *  Which winsock / network stack you're using (with version #)
  422.     *  Windows version #
  423.     *  WinTalk version #
  424.  
  425.  
  426.                 7.0  About ELF
  427.                 ==============
  428.  
  429.     Founded in 1992, ELF Communications is a small,
  430. employee-owned company dedicated to bringing the finest new
  431. networking software to people who use the Internet.  Our products are
  432. designed to be open, easy to use, and powerful without being too
  433. expensive for personal use.  Through our software and activities, we
  434. strive to help the Internet be a medium for honest communication and
  435. a source for increasing world freedom and community.
  436.  
  437.     We are currently working on several commercial projects which
  438. we hope to release some time in 1994.  They include: an intelligent
  439. "majordomo" to assist in common email and news reading tasks such as
  440. subscription maintenance and anonymous FTP-ing; a realtime multimedia
  441. conferencing system supporting file sharing, moderated discussions,
  442. and shared sketchboards; and a graphical information browser to
  443. assist in reading news, email, or file systems.
  444.  
  445.                  ---
  446.  
  447.     The next product I am working on is ERIS, the conferencing
  448. system mentioned above.  It will support such features as:
  449.  
  450. - Realtime multi-user communication over its own protocol or Unix TALK
  451.    (and IRC in later versions)
  452. - Sounds and graphics
  453. - Shared sketchboards
  454. - A flexible "filtering" system for deciding which incoming calls to
  455.    tell you about, refuse, or send to an "answering machine"
  456. - Persistent "Conference Rooms" for discussions and the storage of
  457.    archive files, whiteboards, etc.
  458. - Computer-assisted discussion moderation (floor passing, voting)
  459. - Automatic conversation logging for meeting minutes
  460.  
  461. ...not all necessarily in version 1.  If this sounds interesting to
  462. you, send email to "eris-info-request@elf.com", and I'll add you to
  463. the list for upcoming announcements.  This product is still a ways
  464. off, so don't expect mail about it anytime soon....
  465.  
  466.     Enjoy!
  467.         --Gub (Glen Daniels, ELF Communications)
  468.         March 3rd, 1994
  469.  
  470.  
  471.                  APPENDIX A:
  472.  
  473.   THE SILLY BUT NECESSARY DISCLAIMER THAT OUR LAWYER MADE US INCLUDE
  474.   ------------------------------------------------------------------
  475.  
  476.   BY ACCEPTING THIS SOFTWARE PRODUCT THE USER AGREES TO BE BOUND BY
  477. THE TERMS OF THIS DISCLAIMER.  DO NOT PROCEED FURTHER WITH THE USE OR
  478. INSTALLATION OF THIS SOFTWARE PRODUCT WITHOUT FIRST READING AND
  479. UNDERSTANDING THE TERMS STATED BELOW.
  480.  
  481.   The version of WinTalk (Version 1.1), Copyright (c) 1994 by ELF
  482. Communications, Inc., provided herewith, is hereby distributed as
  483. so-called "freeware".
  484.  
  485.   By that term, ELF Communications, Inc., intends to distribute this
  486. software product without the reservation of any proprietary or other
  487. economic rights.  Each user may, in turn, distribute this software
  488. product to other users without obtaining the permission of ELF
  489. Communications, Inc,; provided only that (i) no user may distribute
  490. the software product, either by itself or in conjuction with any
  491. other product or device, in exchange, either directly or indirectly,
  492. for profit, the intention of profit or any other economic
  493. considerations, without the express written permission of ELF
  494. Communications, Inc., which said permission may be conditioned,
  495. withheld or delayed at its sole discretion, (ii) each copy so
  496. distributed by a users includes this "WINTALK.DOC" file and (iii) the
  497. copy so distibuted has not been altered, modified, impaired or damaged.
  498. Any user who distributes this software product in violation of these
  499. specifically reserved conditions shall be liable for any and all
  500. claims, losses, damages and liabilities resulting therefrom.
  501.  
  502.   ELF COMMUNICATIONS, INC., HEREBY DISCLAIMS ANY AND ALL
  503. REPRESENTATIONS AND WARRANTIES OF ANY KIND, EXPRESS OF IMPLIED, MADE
  504. WITH RESPECT THERETO, INCLUDING, WITHOUT LIMITATION, ANY IMPLIED
  505. WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.
  506.  
  507.   ELF COMMUNICATIONS SHALL HAVE NO LIABILITY TO ANY USER OR ANY OTHER
  508. INDIVIDUAL OR ENTITY CONNECTED OR RELATED TO ANY USER FOR ANY CLAIM,
  509. LOSS OR DAMAGE OF ANY KIND OR NATURE WHATSOEVER ARISING OUT OF OR IN
  510. CONNECTION WITH (I) THE DEFICIENCY OR INADEQUACY OF THE SOFTWARE
  511. PRODUCT FOR ANY PURPOSE, WHETHER OR NOT KNOWN OR DISCLOSED TO THE
  512. USER (II) THE USE OR PERFORMANCE OF THE SOFTWARE PRODUCT OR ANY
  513. FILES, DATA OR COMPUTER SYSTEMS RELATED THERETO OR USED IN CONNECTION
  514. THEREWITH; (III) ANY INTERRUPTION OR LOSS OF SERVICE OR USE OF THE
  515. SOFTWARE, OR ANY FILES, DATA OR OTHER COMPUTER SYSTEMS; (IV) ANY
  516. SOFTWARE FAILURE; OR (V) ANY LOSS OF PROFITS, SALES, BUSINESS, OR
  517. OTHER INCIDENTAL, CONSEQUENTIAL, OR SPECIAL LOSS OR DAMAGE OF ANY
  518. KIND OR NATURE RESULTING FROM THE FOREGOING EVEN IF ELF
  519. COMMUNICATIONS, INC., HAS BEEN INFORMED OR ADVISED OF THE POSSIBILITY
  520. OF SUCH DAMAGES.
  521.  
  522.   Congratulations on making it to the end of the disclaimer!!  Now go
  523. have fun with WinTalk!
  524.